package paidaxing.blog.core.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import paidaxing.blog.core.entity.VisitStats;
import java.util.Date;
import java.util.List;

@Mapper
public interface VisitStatsMapper {
    /**
     * 根据ID查询访问统计
     *
     * @param id 统计ID
     * @return 访问统计实体
     */
    VisitStats queryById(Long id);

    /**
     * 根据日期范围查询访问统计
     *
     * @param startDate 开始日期
     * @param endDate 结束日期
     * @return 访问统计列表
     */
    List<VisitStats> queryByDateRange(@Param("startDate") Date startDate, @Param("endDate") Date endDate);

    /**
     * 根据文章ID查询访问统计
     *
     * @param postId 文章ID
     * @return 访问统计列表
     */
    List<VisitStats> queryByPostId(Long postId);

    /**
     * 插入访问统计
     *
     * @param visitStats 访问统计实体
     * @return 影响行数
     */
    int insert(VisitStats visitStats);

    /**
     * 更新访问统计
     *
     * @param visitStats 访问统计实体
     * @return 影响行数
     */
    int update(VisitStats visitStats);

    /**
     * 根据ID删除访问统计
     *
     * @param id 统计ID
     * @return 影响行数
     */
    int deleteById(Long id);

    /**
     * 统计总访问量
     *
     * @return 总访问量
     */
    Integer countTotalVisits();

    /**
     * 统计今日访问量
     *
     * @return 今日访问量
     */
    Integer countTodayVisits();
}